home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 22 / Cream of the Crop 22.iso / comm / dmi125.zip / README.DMI < prev    next >
Text File  |  1996-09-26  |  14KB  |  277 lines

  1.                        -=≡=- DMI Version 1.2 -=≡=-
  2.         for IRC clients supporting the RxScript REXX IRC Interface
  3.       Copyright (C) 1996, Dusk To Dawn Computing. All Rights Reserved
  4.  
  5. 1. Introduction:
  6. ~~~~~~~~~~~~~~~~
  7.    Thanks for checking out DMI. It was written because I had been using
  8. IceBerg (A good proram in itself), and decided that it just wasn't enough
  9. for me. I didn't know REXX (I'm a dyed-in-the-wool Pascal programmer), so
  10. I learned it. I'm still not that great...but I'm better than I was. :)
  11.  
  12.    DMI pretty much expands on the ideas brought forth by IceBerg. Some
  13. IceBerg commands that I found useless are now gone (Encryption, etc). Some
  14. commands, I either haven't decided to put back in, or haven't finished re-
  15. working yet.
  16.  
  17.    Very little of the code in DMI still has any resemblance to the original
  18. IceBerg. A bit at a time, nearly all of IceBerg has been replaced by my own
  19. code (Take a look at the XDCC code and compare it to IceBerg's, you'll see
  20. what I mean).
  21.  
  22.    The biggest feature for DMI, I suppose, is the new help system. For the
  23. 1.0 release, I had to move the help system into a separate REXX script,
  24. simply because it was too big (~125 lines all by itself). There is a /HELP
  25. hierarchy, with help pages on the miscellaneous commands, MODE commands,
  26. message logger, OS/2 commands, shortcuts, XDCC commands, and DMI variables.
  27.  
  28.    Also new is the capability for making aliases for simple commands. In
  29. fact, many of the shortcut commands (Those that could be done in one or
  30. two lines of REXX) have become aliases to speed up normal script execution.
  31.  
  32.    XDCC has been supercharged! DMI has an almost complete XDCC
  33. implementation, including the ability to change your offer list, display your
  34. current offer list, manually send packs to users, et cetera. It also looks
  35. quite a bit better (To me, anyway. :).
  36.  
  37.    Autologging now works (Among other things, autolog support was broken in
  38. IceBerg 2.51) correctly, as well as redirection of OS/2 commands, which was
  39. broken in an older version of GammaTech IRC.
  40.  
  41.    DMI is Donation-ware. If you like it, then I would always appreciate a
  42. donation of a few bucks, a postcard, an e-mail message, or just a good
  43. conversation on IRC. If you don't like it, that's okay too. :)
  44.  
  45. 2. Disclaimer:
  46. ~~~~~~~~~~~~~~
  47.    DMI is guaranteed only to take up disk space. While this script has
  48. been thoroughly tested, I have no way of knowing what your setup is, and as
  49. always; if it breaks, you have the pieces.
  50.  
  51. 3. Installation:
  52. ~~~~~~~~~~~~~~~~
  53. For GTirc and Internet Adventurer:
  54. Unzip the files in the DMI installation archive into your IRC client's dir.
  55. Load the client. In the options (In GTirc, this is Options -> Startup), you'll
  56. find options for "Input Message Script" and "Output Cmd Script". In the Input
  57. script field, place "DMI-Msg.Cmd". In the Output script field, place
  58. "DMI-Cmd.Cmd". In the "Startup /CMD" field, place "/RUN DMIStart". Type
  59. "/run DMIStart" to initialize, and voila! it's installed.
  60.  
  61. For IRC/2:
  62. Make a \DMI subdirectory branching off your IRC/2 directory. Unzip the files
  63. from the DMI installation archive into this directory. Run the IRC/2 Setup
  64. program. On the REXX tab, add the full paths to the DMI-Cmd.Cmd and
  65. DMI-Msg.Cmd files. Add /load DMI/DMIStart to your ircrc file, and to one of
  66. the following:
  67.  
  68. 1. Add:     'SET PATH=%PATH%;<Path to the DMI directory>'
  69.    near the beginning of your irc.cmd file.
  70.  
  71. 2. Add the path to your DMI directory somewhere in your PATH in CONFIG.SYS.
  72.  
  73. Edit the DMIStart file to customize it to your system, and start IRC/2. DMI
  74. should start.
  75.  
  76. Note: If you don't want to go through all this, you can place the files in your
  77.       base IRC/2 directory. Messier, but it'll work.
  78.  
  79. 4.  Usage:
  80. ~~~~~~~~~~
  81.    First thing I would suggest that you do once you have these
  82. scripts loaded is to start GTirc, and run "/HELP".  Familiarize yourself
  83. with what new commands are available.
  84.  
  85. AutoMode: By setting the AutoMode flag (Using /DMI AutoMode ON), you can
  86. make DMI either give ChanOp status to, or Ban/Kick users meeting specific
  87. User Masks. When a person on this list enters, DMI will (Depending on how
  88. you have that usermask set) give them ops, or ban and kick them. The
  89. AutoMode.Lst file is of this format:
  90.  
  91.    _B, O, or V - O=Op, B=Ban/Kick, V=Voice for moderated channels
  92.   /       _ User Mask in the format *!*@*
  93.  /       /                          __ Channel        __ Comments
  94. /       /                          /                 /
  95. O *!Deek@gra-mi*.netcom.com     #Deek           This is me
  96. B *!*@*aol.com                  #AolSucks       <BANNED because you suck.>
  97.  
  98. The Comments field is not used yet for Ops (DMI may require passwords for
  99. ops in the future, or it may be a toggle), but for Ban/Kick users, you may
  100. use this field as a "Kick Message". When DMI kicks the user from the
  101. channel, this text will be sent to the user to explain why it was done, or
  102. perhaps just to taunt him/her. :)
  103.  
  104.  
  105. XDCC: XDCC is short for "Extended DCC". It is a semi-standard used by
  106. many different scripts. DMI includes almost complete support for XDCC,
  107. including multi-file packs, extended descriptions, a forgiving pack
  108. offer system, keeping track of how many kilobytes have been sent and
  109. are currently being offered to other users.
  110.  
  111. The format of XDCC Offer lists is simple - it takes the format:
  112.  
  113. Pathname Description
  114.  
  115. A sample file, XDCCList is included in the archive. If a file does not
  116. exist or has an incorrect pathname in your XDCC offer list, DMI will send
  117. you an error message, telling you which line has a missing file in it.
  118.  
  119. Since version 1.1a, DMI also supports the usage of "XDCCList.DIZ" files.
  120. DIZ files are for adding extended descriptions to your file offerings.
  121. Simply make a text file of the format:
  122.  
  123. Pack1 Description line 1
  124. Pack2 Description line 1
  125. Pack2 Description line 2
  126.  
  127. By making multiple Pack# lines, you can have multiple lines in your
  128. extended description. To make DMI use the file, name it the same thing
  129. as your pack list, but with the .DIZ extension after it. This means
  130. if you have a pack list file named "FileList.Lst", your extended list
  131. will be named "FileList.Lst.DIZ". This is done so that when you change
  132. your pack list using /XDCC LIST <File>, your extended description list
  133. changes with it. If you have a better idea on how to handle it, I'd like
  134. to hear it.
  135.  
  136. 5. Future Plans:
  137. ~~~~~~~~~~~~~~~~
  138.    There are still a few more things that I want to add to DMI:
  139.  
  140.    1. Adding/deleting packs from XDCC offer lists.
  141.  
  142.    2. Implement a cleaner way to do aliases; I don't like the current
  143.       method very much.
  144.  
  145.    3. Add a DMI_Init file to move the initialization stuff into, making
  146.       DMIStart exclusively for user mods.
  147.  
  148.    4. Add an IRC/2 script to set it up to better support DMI.
  149.  
  150.    5. Convert the DMI help into a set of text files to offer more
  151.       flexibility in editing and user modification.
  152.  
  153. 6. History:
  154. ~~~~~~~~~~~
  155.    It wasn't until 6/13/96 that I decided to record a history, but I am
  156.    going to try to record all major changes from now on. :) These are
  157.    the ones I remember. <grin>
  158.  
  159. 09/26/96 1.25  Fix /C (query) alias for IRC/2 and possibly others.
  160.                Convert DMIHelp.Cmd into a set of help files, *.HLP
  161.                Remove DMIHelp.Cmd from distribution archive.
  162. 09/25/96 1.24  Fix AutoMode - Parts of it weren't respecting the DataDir
  163.                   variable.
  164.                Fix /AUTO's Usage to say /AUTO, not /AUTOMODE. :)
  165.                Add IRC/2 installation info to documentation.
  166. 09/25/96 1.23  Implement DataDir to change the default directory DMI
  167.                   looks in for it's data files. Defaults to .\
  168.                Fix AutoMode so it works with IRC/2 properly
  169. 09/23/96       Misc. minor fixes to aliases.
  170. 09/22/96       Start using the full standard for the IrcRexxSend()
  171.                   function - was causing problems with the IRC/2 beta.
  172. 09/19/96 1.22  Fix kick protection - REXX was getting temperamental.
  173. 09/17/96 1.21  Add SHORTEN.EXE, a utility to shorten text files by
  174.                   saving only the last N lines. It's a bound EXE, so
  175.                   it works in DOS as well.
  176. 09/12/96       Rewrite the Cmd script. Many things should be much faster.
  177.                Noticed something interesting...DMI is now just over 1500
  178.                   lines of code! I think that's kind of impressive. :)
  179.                Add /EDIT alias, which by default starts EPM, the best
  180.                   damn editor on the planet. :)
  181.                Got rid of the /NSL command, /HOST does just as good a job
  182.                   and is much less verbose about it. :)
  183. 09/10/96       Add two new help menus, ALIAS and AUTO.
  184.                Renamed /AUTOMODE to /AUTO. It's simpler that way. :)
  185. 09/05/96 1.20  Wall, WallOp, and CStat commands now default to the current
  186.                   channel if you don't supply one on the command-line.
  187.                New script: AutoMode.Cmd, to handle AutoMode file management.
  188.                New script: Alias.Cmd, to handle alias file management.
  189.                Add multimedia support to CTCP PAGE.
  190.                Add /IDLE that WORKS! I'm very proud of myself. :)
  191. 09/03/96 1.1f  Clean up XDCC list processing. It will now properly handle
  192.                   files 10 megs and over, instead of barfing at 9999K.
  193.                Rewrite about 60 percent of the Inbound Message script. It
  194.                   should be quite a bit faster, as well as cleaner, more
  195.                   reliable, and in general really cool. :)
  196.                Add CTCP PAGE support.
  197.                Add "Paging" variable to script, and DMIStart. "Paging"
  198.                   controls whether or not DMI responds via sound to the
  199.                   CTCP PAGE command.
  200.                Changed archive naming scheme to be nicer to people who like
  201.                   knowing the version by the file date. :)
  202. 08/30/96 1.1e  Informed of a SERIOUS bug in GTirc. Before DMI 1.1d, other
  203.                   users could kill GTirc with a special CTCP command. This
  204.                   has been compensated for, and a warning is now sent when
  205.                   this is attempted by another user.
  206.                Add wildcard for channel names to AutoMode
  207.                Add "Voice" to AutoMode
  208. 07/14/96 1.1d  Merge AutoOp and AutoBK into AutoMode - see above for usage.
  209.                Add /WHOIS logic for prettying up some things.
  210.                Add Time/Date to /AWAY send
  211.                Fix /BK Alias (did the ban, it tried kicking the BKMsg. <G>)
  212. 07/11/96 1.1c  Add XDCC extended description ability. See above for usage.
  213.                Got rid of the extension for DMIStart. Old users will
  214.                   have to change their GTirc setup.
  215. 07/08/96 1.1b  Clean up XDCC pack listing.
  216.                Fix potential problems with split finder logic
  217. 07/05/96 1.1a  Add error checking to XDCC - it now checks if a file exists
  218.                   before checking the file's size - this gets rid of the
  219.                   "REXX Error 40" errors when a file doesn't exist.
  220.                Added multi-file XDCC offer pack (Wildcard) support.
  221. 07/04/96 1.10  Fix /FINDSPLIT - now it will add new servers like it's
  222.                   *SUPPOSED* to. :) (Found old bug in source)
  223.                Added /WALL, /WALLOP - Sends a NOTICE to all users/ops on
  224.                   a channel. Beware, this can get you banned/k-lined if
  225.                   you abuse it!
  226.                Fixed /VOICE, /DEVOICE - were using mode +o/-o instead
  227.                   of +v/-v. :)
  228.                Cleaned up the help a little more. :)
  229. 07/03/96 1.0f  Re-add /DW after being pestered <grin> to do so.
  230.                Add /WEB to script and help (Same as /WWW)
  231. 06/26/96 1.0e  Clean up help (Add internal variables to help, w/ warning)
  232. 06/13/96 1.0d  Fix /J alias (blush)
  233.                Fix/clean up CSTAT
  234.                   (Thanks to Stric for telling me it needed to be done)
  235.                Fix Split Finder...it works now.
  236.                Fix CSTAT, split commands.
  237.                   (they now display on the screen that called them)
  238.                Add /FTP, /LYNX, /TELNET, /WWW aliases.
  239.                Add /FTP, /LYNX, /TELNET, /WWW to help. :)
  240. 06/12/96 1.0c  Add XDCC Total Sent and Total Offered.
  241.                Fix several cosmetic problems
  242. 06/08/96 1.0b  Split the two scripts into 5 for speed purposes.
  243.                   (DMI-Cmd.Cmd - Main Commands)
  244.                   (DMI-Msg.Cmd - Main Message Handling)
  245.                   (DMIHelp.Cmd - Help system)
  246.                   (XDCC_In.Cmd - Inbound XDCC Handling)
  247.                   (XDCC_Out.Cmd - Outbound XDCC Commands)
  248.                  This should speed up execution by quite a bit.
  249. 06/02/96 1.0a  Turn many internal commands into aliases.
  250. 06/02/96 1.00  Add Alias support.
  251.  
  252. 7. Credits:
  253. ~~~~~~~~~~~
  254.    GammaTech
  255.          - for adding REXX support to their IRC client.
  256.  
  257.    Stephen Berg (SSgt)
  258.          - for giving me something to improve. :)
  259.  
  260.    Thomas Ögren (Stric)
  261.          - for finding the /J bug
  262.  
  263.    Syndi Cagle (Syndi)
  264.          - for telling me about the GTirc bug
  265.  
  266.    Andy Boss (Swammy)
  267.          - for bitching about your 20 meg file. :)
  268.  
  269. 8. Contacting me
  270. ~~~~~~~~~~~~~~~~
  271.    I can be found on IRC usually on EFNet using the nickname "Deek". My
  272. E-Mail address is deek@grfn.org.
  273.  
  274.    If you have suggestions *please* E-Mail them to me, that way I can
  275. keep an archive on what suggestions I've looked at/worked on/added in, and
  276. I can also keep track of who suggested what.
  277.